Skip to content

Devlopment Coding Docs initial start.#413

Merged
shlomi-noach merged 6 commits intomasterfrom
develdocs
Jun 4, 2017
Merged

Devlopment Coding Docs initial start.#413
shlomi-noach merged 6 commits intomasterfrom
develdocs

Conversation

@jessbreckenridge
Copy link
Copy Markdown
Contributor

Overview

After cloning the repository I was struggling with how to get started working with the gh-ost codebase.

I have submitted this PR in order to start a page guiding prospective contributers on how to get started with gh-ost development.

While this page is simple for now, I am hoping that it is a good springboard to further PR's on this documentation.

Related issue: #412

Description

This PR creates a doc/coding-ghost.md file that contains instructions for running cibuild. It also details the steps that cibuild performs.

- It is a bit sparse currently, but will give beginners an idea how on to setup the environment and run tests.
- A good starting point for further PR's.
Copy link
Copy Markdown
Contributor

@shlomi-noach shlomi-noach left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you for working on this!

Comment thread doc/coding-ghost.md Outdated
- It runs `script/bootstrap`
- `script/bootstrap` runs `script/ensure-go-installed`
- `script/ensure-go-installed` installs go locally if (go is not installed) || (go is not version 1.7). It will not install go if it is already installed locally and at the correct version.
- `script/build` builds the `gh-ost` binary and places in in `bin/`
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think enumerating the exact steps taken by the script is error prone. e.g. what happens if the script ensures go 1.8 -- will this text be updated?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good point, let me strip this down.

Comment thread doc/coding-ghost.md Outdated

Getting started with gh-ost development is simple!

- First clone the repository.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should we clone via git clone or via go get?

Comment thread README.md Outdated

We develop `gh-ost` at GitHub and for the community. We may have different priorities than others. From time to time we may suggest a contribution that is not on our immediate roadmap but which may appeal to others.

Please see [Coding gh-ost](https://github.com/github/gh-ost/blob/develdocs/doc/command-line-flags.md) for a guide to getting started developing with gh-ost.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

👍

@jessbreckenridge
Copy link
Copy Markdown
Contributor Author

@shlomi-noach Are additional changes needed before merging this PR?

@shlomi-noach shlomi-noach merged commit 5585c25 into master Jun 4, 2017
@shlomi-noach shlomi-noach deleted the develdocs branch June 4, 2017 05:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants